home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 2 / Atari Forever 2.zip / Atari Forever 2.iso / serie_v / v_432 / picsw7.doc < prev    next >
Text File  |  1991-03-25  |  15KB  |  294 lines
  1.    ==========================================================================
  2.                            PicSwitch Picture Utility
  3.                    (c)1987 John Brochu for Advanced Software
  4.    ==========================================================================
  5.  
  6.    Version: 0.7
  7.    Released: April 19, 1987
  8.  
  9.    PicSwitch 0.7 is distributed as SHAREWARE.  You are encouraged to freely
  10.    distribute the program, but please include this doc file with the program.
  11.  
  12.  
  13.    --------------------------------------------------------------------------
  14.    New features
  15.    --------------------------------------------------------------------------
  16.    The following enhancements have been added from PicSwitch 0.6 ...
  17.     o  Runs on color AND monochrome systems, all features supported on both
  18.        monitors except PREVIEW (color only)
  19.     o  New formats: DEGAS compressed, Tiny, and Atari 8-bit files
  20.     o  Much improved low-res and med-res to monochrome conversions
  21.     o  PicSwitch printer driver now supports all three resolutions
  22.     o  Color cycling is now supported, and is converted between formats
  23.     o  Converted pics are now saved to the original pic's directory, or
  24.        optionally using the file selector to any drive/path
  25.  
  26.  
  27.    --------------------------------------------------------------------------
  28.    About PicSwitch
  29.    --------------------------------------------------------------------------
  30.    PicSwitch started out as a simple Amiga IFF file viewer back when ST paint
  31.    programs  were hard to come by (around October of '85)!  Since then it has
  32.    undergone  lots of upgrading through versions 0.5 (the original), 0.6, and
  33.    now  0.7.  The basic intent of the program is to provide ST users with the
  34.    ability  to  view  as much artwork as possible, and to convert to a format
  35.    that  is usable to them on the ST.  With this version I have addressed the
  36.    major  complaint most people have had with the program, that is monochrome
  37.    support!
  38.  
  39.    All  pics can be viewed on either the color or monochrome monitor, and can
  40.    be  saved  in any resolution with either system, with automatic conversion
  41.    to  the selected resolution.  Conversions from a higher res to a lower res
  42.    are  automatically  optimized  using  a  color  averaging technique, while
  43.    conversions from low & med-res to monochrome use a sophisticated dithering
  44.    technique.
  45.  
  46.    Conversions  from  monochrome  allow  you the option of saving the picture
  47.    using  the  full  palette  (best if you may want to restore the pic to its
  48.    original  state  at  a  later  date)  or with the minimum possible palette
  49.    (low-res conversions would use 5 colors, med-res 3).
  50.  
  51.    MacPaint  and  NVision/Paintworks monochrome page files are also allowed a
  52.    fourth  res-save  option.   Compressed save allows you to 'squeeze' a full
  53.    720-line MacPaint document or 800-line Paintworks pic into only 240 or 267
  54.    med-res  lines,  thus  allowing  you  to view more of the pic on screen at
  55.    once.
  56.  
  57.    On  a  color  monitor,  you are allowed to 'Preview' the conversion before
  58.    saving,  without  affecting  the  original  picture.  Hi-res previews will
  59.    display the picture in PicSwitch's 'simulated monochrome' mode.
  60.  
  61.    Printouts  of  ANY  screen  or  full-page picture can now be done with the
  62.    built-in  driver on most 8-pin graphics printers.  You can also load DEGAS
  63.    printer drivers for printouts if you wish.
  64.  
  65.  
  66.    --------------------------------------------------------------------------
  67.    Supported formats
  68.    --------------------------------------------------------------------------
  69.    This version reads the following file formats:
  70.         o  DEGAS................................. [.PI1-.PI3]
  71.         o  DEGAS Elite compressed................ [.PC1-.PI3]*
  72.         o  NeoChrome.................................. [.NEO]
  73.         o  Tiny............................... [.TNY, .TN1-3]*
  74.         o  NVision.................. [.SC0-2, .CL0-2, .PG0-2]
  75.         o  Amiga IFF low- & med-res................... [.IFF]
  76.         o  MacPaint................................... [.MAC]
  77.         o  Mac Startup screen......................... [.MAS]
  78.         o  CIS Vidtex hi-res RLE...................... [.RLE]
  79.         o  Atari graphics 8 screen dump............... [.GR8]*
  80.         o  Atari graphics 9 screen dump............... [.GR9]*
  81.         o  Atari Koala/MicroIllustrator............... [.KOA]*
  82.         o  Atari MicroPainter......................... [.MPT]*
  83.  
  84.    And writes the following ST file formats:
  85.         o  DEGAS
  86.         o  DEGAS Elite compressed*
  87.         o  NeoChrome
  88.         o  NeoChrome 'page' (for NVision)
  89.  
  90.    *New additions from 0.6
  91.  
  92.  
  93.    --------------------------------------------------------------------------
  94.    Using the program
  95.    --------------------------------------------------------------------------
  96.    To  load  a  picture  using  the  GEM  file  selector, double click on its
  97.    filename  or  single-click  and  then  click  OK.   The file will load and
  98.    display.   You  are  now  in  'command  mode'.  Following is a list of key
  99.    commands available:
  100.  
  101.    For all pics...
  102.    ---------------
  103.     o  [Undo], right mouse button: aborts the pic and returns you to the file
  104.             selector.
  105.     o  [Help]: displays the command list.
  106.     o  [I]: displays the information screen.
  107.     o  [S]: displays the save dialog (see below).
  108.     o  [P]: prints the current pic in its original form (screen OR
  109.             full-page).  [Undo] aborts a printout.  The default printer type
  110.             is Epson/Atari dot matrix.  Other printers capable of 8-bit
  111.             graphics can be configured using a ".PSW" driver as described
  112.             further on.
  113.     o  [D]: dumps a color or monochrome screen to the printer.  To use this
  114.             option, you must have a DEGAS printer driver with a ".PRT"
  115.             extender present in the directory the program is in when it is
  116.             first run.  The [Alt] key works as in DEGAS, ie.[D] prints a full
  117.             page sideways, [Alt-D] prints a half-page.  Pressing [Undo]
  118.             during a print aborts the dump.
  119.  
  120.    For MacPaint/NVision pics only...
  121.    ---------------------------------
  122.     o  left mouse button: activates a 'grabber' similar to Neochrome.
  123.     o  [C] (monochrome pics / color system only): compress a monochrome page
  124.             vertically.  This option converts 3 monochrome lines into 1
  125.             med-res line.  Therefore a 720-line MacPaint document would
  126.             reduce to a 240-line med-res scrollable image.  Pressing this a
  127.             second time restores the original image.  Note this option is
  128.             available in the save dialog on both monitors.
  129.  
  130.    For Amiga IFF pics only...
  131.    --------------------------
  132.     o  [1]-[6]: selects the bit-planes to be displayed.
  133.     o  [Space]: cycles through settings [1]-[6].
  134.     o  [R],[G],[B]: boosts the selected color.
  135.     o  [Return]: restores the default planes and colors.
  136.  
  137.    Low-res  32-color  pics  have  5  'planes'  or  5  bits  of color-register
  138.    selection.   Keys 1-5 'pull out' one of the planes for display on the ST's
  139.    4-plane hardware.
  140.  
  141.    Med-res  16-color  pics have 4 planes.  Keys 1-6 in med-res therefore need
  142.    to pull out 2 planes at a time.  The following table summarizes the planes
  143.    that are displayed.  The space bar cycles through each in turn.
  144.  
  145.         +-----+---------+-----+
  146.         | key |   low   | med |
  147.         +-----+---------+-----+
  148.         |  1  | 1,2,3,4 | 2,3 |
  149.         |  2  | 0,2,3,4 | 1,3 |
  150.         |  3  | 0,1,3,4 | 1,2 |
  151.         |  4  | 0,1,2,4 | 0,3 |
  152.         |  5  | 0,1,2,3 | 0,2 |
  153.         |  6  | ---na-- | 0,1 |
  154.         +-----+---------+-----+
  155.  
  156.    Amiga's  hardware also allows 4-bit color resolution, or 16 levels each of
  157.    red,  green,  and  blue.  Since the ST only has 3-bit resolution, each IFF
  158.    RGB  color  palette entry is cut in half to bring it into the ST's range.
  159.    The  R,G,B  keys  add  one to the IFF value before halving it.  This helps
  160.    bring  out  some  of  the detail that may be lost if some of the registers
  161.    convert to the same color.
  162.  
  163.    Other pics...
  164.    -------------
  165.     o  [SPACE] (RLE & GR8 pics): invert the palette.
  166.     o  [SPACE] (GR9 pics): select red/green/blue gray scale.
  167.  
  168.  
  169.    --------------------------------------------------------------------------
  170.    The SAVE Dialog
  171.    --------------------------------------------------------------------------
  172.    The  top  three  lines  in  the  dialog indicate the loaded picture's path
  173.    (directory),  filename,  and  original  picture format.  You can choose to
  174.    save in any format and resolution by selecting the desired buttons.
  175.  
  176.    If you are using a color monitor, you can Preview what the image will look
  177.    like  in the selected format by clicking and holding the 'Preview' button.
  178.    If  you're  running  a  monochrome  monitor, this button will be disabled;
  179.    however, you can still save in any format on both monitors.
  180.  
  181.    For  mono  to  low-  and  med-res  conversions,  you  have  the  option of
  182.    converting the pic using all 16 or 4 palette colors ("FULL"), or using the
  183.    "MINIMUM" possible number of colors (5 low-res, 3 med-res).
  184.  
  185.    Once  you  have  selected the desired format, res, and palette set-up, you
  186.    can  save the pic using the "SAVE --------.---" or "SAVE AS" buttons.  The
  187.    SAVE  button  will  save  to the directory that the original pic came from
  188.    (displayed on the top line of the dialog).  SAVE AS will bring up the file
  189.    selector  so  that you can save to any drive/directory you like, or change
  190.    the filename.  Note the save file selector's directory is always preserved
  191.    and  saved separately from the load file selector, so that you can quickly
  192.    convert many pics from one drive/directory to another.
  193.  
  194.    If  you  specify an extender in the file selector, it will be ignored, and
  195.    the  proper  file extender for the specified pic format will automatically
  196.    be  appended.   Selecting Cancel in the file selector will get you back to
  197.    the Save dialog with no action taken.
  198.  
  199.    If  the  original  pic  had color cycling information, and you save to the
  200.    same  resolution,  the cycling info will be preserved and saved in the new
  201.    file.  Converting to/from DEGAS or Elite format will use animation channel
  202.    one.
  203.  
  204.  
  205.    --------------------------------------------------------------------------
  206.    Printer Drivers
  207.    --------------------------------------------------------------------------
  208.    Printer  drivers  are loaded automatically when you first run the program.
  209.    The  file  extenders  ".PRT"  and  ".PSW"  are searched for in the current
  210.    directory  (this  allows  you  to  have all PicSwitch-related files in one
  211.    folder if you like).  The first file of each type that was written to that
  212.    directory  is  loaded.   A  PRT file is necessary to use the screen [D]ump
  213.    command.   These  are  the  stand-alone  2K DEGAS printer drivers that are
  214.    available  on  GEnie,  CIS,  Delphi,  and  other  systems.   A PSW file is
  215.    necessary  to  use  the  [P]rint  command  only  if  you  do  NOT  have an
  216.    Epson-compatible printer.
  217.  
  218.    The printer driver in the current version of PicSwitch only supports 8-pin
  219.    graphics  and  960  dots  per  line  density.   PSW  files  are text files
  220.    containing  the  decimal ascii codes necessary for setting up your printer
  221.    for  graphics.  All PSW files must have three command lines separated by a
  222.    single  carriage  return.   Only  the  ascii  characters  0-9, L, l, H, h,
  223.    <comma>,  <space>,  and  CR/LF  are  recognized;  all other characters are
  224.    ignored.   Each  printer  code  must  be  separated  by  a  space or comma
  225.    delimiter.  A maximum of 32 codes are allowed on each line.
  226.  
  227.    The  first  line  contains the decimal codes for initializing your printer
  228.    for  graphics.  These codes are sent to the printer only once at the start
  229.    of a graphics dump.  The second line is sent before every line of graphics
  230.    and  tells  the printer how many columns of data are to follow.  The third
  231.    and  final  line  is sent after the graphics dump is finished and restores
  232.    the printer to normal operation.
  233.  
  234.    The following is a sample PSW file (this is the built-in EPSON default):
  235.    27 51 23
  236.    27 76 L H
  237.    27 50
  238.  
  239.    The  1st  line:  <ESC>  "3" 23, tells the Epson to set the line spacing in
  240.    216ths  of an inch increments, to 23/216 of an inch.  You could substitute
  241.    any  line spacing command you like here.  I found this setting worked very
  242.    well   in  getting  rid  of  the  dreaded  white  lines.   [Warning:  some
  243.    "Epson-compatibles" do not support this escape code.  Consult your printer
  244.    manual  if  you  have  problems.]   Note  that  24/216 or 8/72 is the more
  245.    'correct' setting to use here since the Epson's pin spacing is 1/72".
  246.  
  247.    The 2nd line: <ESC> "L" L H, tells the Epson to print (L+256*H) columns of
  248.    960  dots  per  line  graphics.  You need not be concerned with the actual
  249.    'L'ow and 'H'igh values here, PicSwitch will substitute the correct values
  250.    for  L  and  H  according to how long the actual line of picture data is.
  251.    Just  make sure you put the L and H in the correct place for your printer.
  252.    Note you MUST use 960 dots per line density.
  253.  
  254.    The  3rd line: <ESC> "2", tells the Epson to return to the original 1/6 of
  255.    an  inch  line  spacing.  You could also use a 'reset' command here (<ESC>
  256.    "@" for the Epson) if you wish.
  257.  
  258.    A  form  feed  is  sent at the end of each completed printer dump.  If the
  259.    printer is not available or a driver was not loaded, the console bell will
  260.    sound.
  261.  
  262.    All  printouts  done  with  either  [P]rint  or  [D]ump are printed in the
  263.    ORIGINAL  picture's  resolution, not from screen memory.  This allows mono
  264.    pics  to  be printed with no loss of resolution.  MacPaint/Paintworks pics
  265.    cannot  be  printed  in  compressed mode unless you first save the file in
  266.    compressed form, reload it, and then print it out.
  267.  
  268.    Remember,  the  [D]ump command is for screen dumps only, and only works if
  269.    you  have  loaded a DEGAS printer driver at run-time.  If the picture is a
  270.    full-page  MacPaint  or Paintworks image, the section of the pic currently
  271.    displayed is what gets printed.
  272.  
  273.  
  274.    --------------------------------------------------------------------------
  275.    Thanks!
  276.    --------------------------------------------------------------------------
  277.    Again,  many  thanks to everyone who took the time to write us, especially
  278.    those who have contributed.  You will not be forgotten!
  279.  
  280.    Please  consider  the time it takes to develop and debug a utility such as
  281.    this.   If  you  haven't  already  contributed, please honor the shareware
  282.    policy and send your contribution, however small, to the address below.
  283.  
  284.    As always, I can be reached on GEnie [JAKOB], CIS [70376,1235], and Delphi
  285.    [JAKOB],  or  you  can  write  me  at  the address below.  If you have any
  286.    comments or ideas, I'd like to hear from you!
  287.  
  288.            John Brochu
  289.            Advanced Software
  290.            21 Northend Street
  291.            Peabody, MA  01960
  292.  
  293.    ==========================================================================
  294.